home *** CD-ROM | disk | FTP | other *** search
/ AOL File Library: 2,801 to 2,900 / aol-file-protocol-4400-2801-to-2900.zip / AOLDLs / C++ Files Library / CModalDialog C++ Class / CModalDialogClass.v100.sit / CModalDialog Class / READ ME < prev    next >
Text File  |  1995-10-11  |  2KB  |  43 lines
  1. CModalDialog Class
  2. by Michael F. Kamprath
  3. Copyright ⌐ 1995 by Michael F. Kamprath, All rights reserved.
  4. mailto:kamprat@leonardo.net
  5. http://www.leonardo.net/kamprath
  6.  
  7. CModalDialog is a C++ class which takes over the basics of displaying a dialog.Below is a sample of CModalDialog╒s use.
  8.  
  9. void DisplayThatDialog( void )
  10. {
  11. CModalDialog     theDialog( 128 );
  12. short            itemHit;
  13. Boolean          done = false;
  14.  
  15.      theDialog.Show();
  16.  
  17.      while (!done)
  18.      {
  19.            itemHit = theDialog.DoOneModalLoop();
  20.  
  21.            switch (itemHit)
  22.            {
  23.                  case kOK:
  24.                       done = true;
  25.                       break;
  26.            }
  27.      }
  28. }
  29.  
  30. CModalDialog allows you to define the current default and cancel buttons on the fly. It also allows you to customize the dialog through filters by simply inheriting CModalDialog and modifying the proper virtual filter functions. Documentation for CModalDialog╒s various public functions can be found in CModalDialog.h. Please note that CModalDialog uses the dialog╒s refcon to store the object╒s ╥this╙ pointer. This is done so that the global static filter function can access the CModalDialog object╒s filter functions. You should not modify the dialog╒s refcon, and theorectically, you have no need to utilize the ╥this╙ pointer from it.
  31.  
  32. I have supplied an example class in the Sample Code folder. This example class demonstrates how you can inheirit off of CModalDialog to implement a ╥type╙ of dialog, specifically, a dialog with a text box. Documentation on this sample class is sparse, but I beleive the code to be readable by most programmers. 
  33.  
  34. If you have any questions or suggestions, feel free to e-mail me. If you come up with any useful sub-classes of CModalDialog, send them my way and I╒ll include them with the archive.
  35.  
  36. License
  37.  
  38. This code may be freely used in free and shareware products. Commercial product users must supply me with a free, fully licensed copy of the product this code is used in. In either case, users should notify me of their use of this code so that I can keep them notified of updates.
  39.  
  40. This code may be freely distributed in it's non-modified form. It's original archive should be kept intact.
  41.  
  42. This code is provide ╥as-is.╙ 
  43.